home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / eracem.zip / ERACEM.DOC next >
Text File  |  1992-01-25  |  7KB  |  194 lines
  1.  
  2.  
  3.    ┌────── WARNING ──────────────── WARNING ─────────────── WARNING ──────┐
  4.    │                                                                      │
  5.    │    THIS IS A BETA VERSION!  This BETA version of eRACEm has been     │
  6.    │    released to the general public under the following conditions:    │
  7.    W                                                                      W
  8.    A      1: You accept FULL responsibility for any and all damage        A
  9.    R         this software may cause to your system because of bugs       R
  10.    N         or any other unforseen problems.                             N
  11.    I                                                                      I
  12.    N      2: You should not expect bug fixes or updates with any          N
  13.    G         regularity nor should you expect elaborate docs or           G
  14.    │         packaging.                                                   │
  15.    │                                                                      │
  16.    │                                                                      │
  17.    │                                                                      │
  18.    └────── WARNING ──────────────── WARNING ─────────────── WARNING ──────┘
  19.  
  20.  
  21. DO NOT use this software if any of the above bothers you. eRACEm has been
  22. running in the daily maintenance batch file of a number of systems for a
  23. few weeks now.  So far, all has gone well but you should still excercise
  24. caution.
  25.  
  26.  
  27. eRACEm; A RemoteAccess Pack (Erase 'em) and sort utility.
  28.  
  29. Disclaimer:
  30.  
  31. If you use this, you accept any damage or loss that may occur with your
  32. user related files.  If you cannot accept this condition then DO NOT use
  33. this program.
  34.  
  35. I made every effort to insure eRACEm is safe to use.  It has worked
  36. perfectly for me but things can go wrong and bugs can surface under
  37. conditions which I did not and cannot forsee.
  38.  
  39. eRACEm makes NO attempt to share the user files with any other task.  If
  40. you attempt to pack or sort the user file while RA is active, you are
  41. asking for trouble and eRACEm will most likely give it to you.
  42.  
  43. Purpose:
  44.  
  45. eRACEm is a replacement for the RAUSER packing utility supplied with
  46. RemoteAccess.  While RAUSER is a fine utility, it does not provide the
  47. number of options many SysOps want.
  48.  
  49. eRACEm will pack your user file using all the familiar RAUSER options and
  50. adds a few more.  Additionally, eRACEm can sort the user file in the same
  51. run and do so on multiple fields in user selectable ascending or descending
  52. order.
  53.  
  54. eRACEm was written to replace the built in Pack/Sort options of a future
  55. version of RACE and as such, requires a valid RACE.CFG file for various
  56. bits of info.
  57.  
  58. usage:
  59.  
  60. You may mix and match any of the pack switches with the sort options or you
  61. may pack only or sort only.
  62.  
  63. PACKING -
  64.  
  65. Pack Switches:
  66.  
  67. -P   pack the user file, removing deleted users.  This switch is only
  68.      necessary if you do not use either the -D or -G switch.
  69.  
  70. -Ms  Do not purge users that are ABOVE (s) security level.  This is
  71.      slightly different than RAUSER for which this switch means do
  72.      not purge users AT this level or above.
  73.  
  74.      -M10 will allow purging of security level 10 and below in eRACEm
  75.      but RAUSER will do only those users below 10 with this switch.
  76.  
  77.      Think of it as the -M(aximum) level to purge.
  78.  
  79. -Dn  purge users that have not called in n days.
  80.  
  81. -Gg  Purge users in Group g.
  82.  
  83. -K   DO NOT honor the no-kill flag.  If the user has the no-kill flag
  84.      set, it will not protect him/her if any of the other parameters
  85.      are met.
  86.  
  87. -O   Write deleted users to USERS.OLD.  This is a USERS.BBS type of file
  88.      that is used by RACE in the WHOOPS! option.  WHOOPS! can restore
  89.      purged users.  Useful if you mistakenly use -D6 instead of -D60 and
  90.      wipe out 90% of your users.
  91.  
  92.      See the RACE documentation for more information on USERS.OLD and the
  93.      RACE Whoops! function.
  94.  
  95. -L   Log the results of a pack to RACEPACK.LOG.  This log file will contain
  96.      the user's name, security level, group and last time called in date and
  97.      number of days format.  All this info is written for each user no matter
  98.      which command line switches were used.  The name of this log is hard
  99.      coded into eRACEm.
  100.  
  101.  
  102. SORTING -
  103.  
  104. The sorting of the user file works quite a bit differently than both the
  105. internal RACE sort and the sort provided by RA's RAUSER program.
  106.  
  107. eRACEm will make use of EMS (if available) or the hard drive for temporary
  108. files if the user file is so large it cannot be sorted entirely in memory.
  109. This should solve the problem some have had with RACE while trying to sort
  110. user files that contained in excess of 2000 users.
  111.  
  112. Like the RACE internal sort, eRACEm will allow you to sort on a number of
  113. selectable fields. The difference is that eRACEm will allowing sorting on
  114. more than one field at a time.  A few additional fields have been added to
  115. eRACEm.
  116.  
  117. Here are the allowable sort fields:
  118.  
  119. Name  Security  Group  UpK  DownK  Ups  Downs  Posts  Calls  Credit  Pending
  120.  
  121. The names of the sort field options are pretty descriptive so I won't bore
  122. you with a description of what each one is.
  123.  
  124. In addition, you MUST specify a ascending or descending sort of a field by
  125. appending a + or - to the sort field name.
  126.  
  127. eRACEm will allow you to specify as many sort keys as there are field
  128. options to sort on but keep in mind that it makes little sense to use more
  129. than two or maybe three sort keys.
  130.  
  131. Here's a quick example and the results of this one would be fairly familiar
  132. to all RAUSER sorters out there.
  133.  
  134. eRACEm -S[Security- Name+]
  135.  
  136. This sort command line would first sort the users by security level in
  137. a highest level to lowest level and within those security levels, sorted by
  138. name, A to Z.  This is the method "RAUSER -S" provides.
  139.  
  140. Note that the delimiters =ARE REQUIRED= to delimit the sort options
  141. IF you want to use more than one option.  DO NOT use delimiters if you
  142. only sort on one field.
  143.  
  144. Allowable delimiting characters are [], "" and '', i.e. square brackets,
  145. double quotes and single quotes.
  146.  
  147. A sort on name only would appear like so...
  148.  
  149. eRACEm -Sname+
  150.  
  151. The + and - appended to the sort key name is NOT optional.  One or the
  152. other (plus or minus) must be used.
  153.  
  154. The sort is performed in the order in which the keys are used.  The
  155. first key is the primary key and so on.
  156.  
  157. Another example:
  158.  
  159. eRACEm -S"Name+ Security-"
  160.  
  161. Using the NAME as the primary key is a valid method.  If you use the NAME
  162. as a primary key, having a secondary key is almost useless.
  163.  
  164. Why?  It is very unlikely that a system will have more than one or two
  165. users with the EXACT same last name.  Since the above command line will
  166. first sort on last name, the security level will only come into play if two
  167. or more users have the exact same last name.
  168.  
  169.  
  170. Yet another example:
  171.  
  172. eRACEm -S'Security- Group+ Name+'
  173.  
  174. Here is what this would produce:
  175.  
  176. Security   Group   Last Name
  177. --------------------------
  178.  100         0      ADAMS
  179.  100         0      BAKER
  180.  100         1      ANDREWS
  181.  100         1      CHARLES
  182.   90         0      ANDERSON
  183.   90         1      AARON
  184.   90         2      ALLAH
  185.   90         2      BELDON
  186.  
  187.  
  188. And that's all he wrote for now.  Hope it works ok for you :-)
  189.  
  190.   mike
  191.  
  192.  
  193.  
  194.